home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Utilities / Programming / C Reference Card 3.0 / C Reference Card / C Reference Card.rsrc / TEXT_411_11.txt < prev    next >
Encoding:
Text File  |  1997-07-17  |  3.2 KB  |  125 lines
  1. TEMPLATES : template functions, template classes
  2. _________________________________________________________________________
  3.  
  4.  
  5. TEMPLATE FUNCTIONS
  6.  
  7. C++ provides the capability to construct template functions.  Anytime you find yourself writing several functions which perform the same function on different data types, you should considered writing a template function.  Although you could 'overload' a function to perform the same operations on each data type needed, template functions allow you to write the code once.  The compiler performs the work of creating the needed code for each data type used in the program.  Here's an example:
  8.  
  9.   // template.cp
  10.   #include <iostream.h>
  11.  
  12.   template <class T> T abs( T val )
  13.   {
  14.     if( val < 0 )
  15.       val = -val;
  16.     return val;
  17.   };
  18.  
  19.  
  20.   main()
  21.   {
  22.     int   i1 = -4;
  23.     int   i2 = 237;
  24.     float f1 = -3.14;
  25.     float f2 = 5.83;
  26.  
  27.     cout << abs(i1) << endl;
  28.     cout << abs(i2) << endl;
  29.     cout << abs(f1) << endl;
  30.     cout << abs(f2) << endl;
  31.  
  32.     return 0;
  33.   }
  34.   // end template.cp
  35.  
  36. The declaration 'template <class T>' should be read something like "a template of class T".  In the above example, the function 'abs' takes one argument named 'val' of type T, and has a return value of type T.  You can have multiple class types within a template declaration such as:
  37.  
  38.   template <class A, class B> int myFunction( A x, B y, int z )
  39.  
  40. Here, the template 'myFunction' takes three arguments and returns an integer.
  41.  
  42.  
  43.  
  44. TEMPLATE CLASSES
  45.  
  46. You can also create template classes in much the same way as you create template functions.  Template classes can be used to define container classes to make it easy for you to create linked lists of all sorts of data without having to write a whole bunch of code.  The following is a simple example of using a template class that keeps a running total.
  47.  
  48.   // sum.cp
  49.   #include <iostream.h>
  50.  
  51.   template<class T> class Sum
  52.   {
  53.       T totalValue;
  54.       T lastValue;
  55.     public:
  56.       Sum();
  57.       ~Sum();
  58.       void add(T &);
  59.       T total(void);
  60.       T last(void);
  61.       void undo(void);
  62.   };
  63.  
  64.   template<class T> Sum<T>::Sum()
  65.   {
  66.     // constructor
  67.     totalValue = (T)0;
  68.     lastValue = (T)0;
  69.   }
  70.  
  71.   template<class T> Sum<T>::~Sum()
  72.   {
  73.     // destructor
  74.   }
  75.  
  76.   template<class T> void Sum<T>::add(T &val)
  77.   {
  78.     lastValue = val;
  79.     totalValue = totalValue + lastValue;
  80.   }
  81.  
  82.   template<class T> T Sum<T>::total(void)
  83.   {
  84.     return totalValue;
  85.   }
  86.  
  87.   template<class T> T Sum<T>::last(void)
  88.   {
  89.     return lastValue;
  90.   }
  91.  
  92.   template<class T> void Sum<T>::undo(void)
  93.   {
  94.     totalValue = totalValue - lastValue;
  95.     lastValue = -lastValue;
  96.   }
  97.  
  98.   main()
  99.   {
  100.     Sum<int> RunningTotal;
  101.     
  102.     int i1 = 4;
  103.     int i2 = 8;
  104.     int i3 = 1;
  105.     int i4 = 7;
  106.     
  107.     RunningTotal.add(i1);
  108.     RunningTotal.add(i2);
  109.     RunningTotal.add(i3);
  110.     RunningTotal.add(i4);
  111.     
  112.     cout << "Total = " << RunningTotal.total() << endl;
  113.     cout << "Last Item = " << RunningTotal.last() << endl;
  114.  
  115.     cout << "Undo Last Operation..." << endl;
  116.     RunningTotal.undo();
  117.     cout << "Total = " << RunningTotal.total() << endl;
  118.  
  119.     cout << "Undo Last Operation (again)..." << endl;
  120.     RunningTotal.undo();
  121.     cout << "Total = " << RunningTotal.total() << endl;
  122.  
  123.     return 0;
  124.   }
  125.   // end sum.cp